home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 016a / fdsk11.zip / FREEDISK.DOC next >
Text File  |  1991-11-10  |  9KB  |  245 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.        
  8.        FREEDISK.EXE 1.1
  9.        Copyright 1991 by Chuck Steenburgh
  10.        
  11.           Ever started a program only to find out that your disk
  12.        did not have enough room to store any data?  Want to have
  13.        your batch files tell you when it is time to swap disks or
  14.        clean up your hard drive?  FREEDISK to the rescue!  FREEDISK
  15.        can be used from the command line as a quick way to deter-
  16.        mine your remaining disk space (much faster than using the
  17.        DOS commands like dir or chkdsk).  FREEDISK really shines,
  18.        however, in batch files, where it can help your batch file
  19.        programs make decisions based on remaining disk space.
  20.        
  21.        Usage:       FREEDISK [drive] [space] [/SK | /SB] [/H]          |
  22.        
  23.                  drive           a single letter representing
  24.                                  the disk drive you want to
  25.                                  check.  You don't need a colon,
  26.                                  and the default is the current
  27.                                  disk drive.  [optional]
  28.        
  29.                  space           the number of kilobytes of free
  30.                                  disk space you feel is necessary
  31.                                  in order to continue.  A kilo-
  32.                                  byte is 1,024 bytes (binary pur-
  33.                                  ist that I am!).  [optional]
  34.                                  
  35.                  /SK             screen report of free space in kilo-  |
  36.                                  bytes rather than megabytes.  Error-  |
  37.                                  level report is still in 10K incre-   |
  38.                                  ments.                                |
  39.                                  
  40.                  /SB             screen report of free space in        |
  41.                                  bytes rather than megabytes.  Error-  |
  42.                                  level report is still in 10K incre-   |
  43.                                  ments.                                |
  44.                                  
  45.                  /H              displays brief syntax help            |
  46.        
  47.        Examples: 
  48.        
  49.             FREEDISK             displays the total and available
  50.                                  space on the current dirve.  Also
  51.                                  returns available space as error-
  52.                                  level (see below).
  53.        
  54.             FREEDISK b           displays the total and available
  55.                                  space on drive B.
  56.        
  57.             FREEDISK 10000       displays the total and available
  58.                                  space on the current drive.  If
  59.                                  the available space is less than
  60.                                  10,000 kilobytes, FREEDISK will
  61.  
  62.                                      Page 1
  63.  
  64.  
  65.  
  66.  
  67.  
  68.                                  sound an alarm and set the error-
  69.                                  level.
  70.                                  
  71.             FREEDISK /SK a 30    displays the total and available      |
  72.                                  space on drive A in kilobytes.  If    |
  73.                                  the available space is less than 30K, |
  74.                                  FREEDISK will sound an alarm and set  |
  75.                                  the errorlevel to "1."                |
  76.        
  77.           FREEDISK normally displays available and total space in mega-|
  78.        bytes (unless you have specified either the /SK or /SB switch). |
  79.        Since a megabyte is 1,024 kilobytes or 1,048,576 bytes, the 
  80.        numbers shown might look a little different than what the guy 
  81.        who sold you your disk drive said.  That's OK, salesmen tend to 
  82.        define a "K" as 1,000 so they can make their products look 
  83.        better.  It's all the same, you're not losing any bytes one way 
  84.        or another.  My salesman, for example said my Seagate ST-251 
  85.        had 42 megabytes; FREEDISK reports it at only 40.6 meg.
  86.        
  87.           FREEDISK will return one of several possible errorlevels:    |
  88.        
  89.             0   Normal termination, sufficient disk space available
  90.             1   Not enough space available                             |
  91.            254  Help displayed, no report                              |
  92.            255  Error reading available disk space                     |
  93.                 
  94.           When the no needed space is indicated on the command line,
  95.        FREEDISK will set the errorlevel equal to the amount of space
  96.        available on the drive, in 10K increments.  For example, if
  97.        you specify "FREEDISK A" on the command line, and drive A has
  98.        240K of free space left, FREEDISK will return an errorlevel of
  99.        24.  If there are more than 2.53 megabytes available, the 
  100.        errorlevel will be set to 253.  This feature is useful when
  101.        you want your batch file to selectively delete files on the
  102.        target until a certain amount of space remains (for example).
  103.        
  104.        DISCLAIMER
  105.        
  106.           The programs described in this documentation are guaran-
  107.        teed to absolutely nothing!  They have, however, in my exper-
  108.        ience performed essentially as described herein.  The author
  109.        will not be responsible for any loss or damages caused through
  110.        the use of these programs.
  111.        
  112.           All trademarks are property of their respective owners.
  113.        
  114.           The programs and documentation are Copyright 1991 by Chuck
  115.        Steenburgh.  You are encouraged to distribute these programs
  116.        provided the following conditions are met:
  117.        
  118.           - all files listed in the file FILES.TXT must be distrib-
  119.             uted together in UNMODIFIED form
  120.        
  121.           - you charge no more than a reasonable fee for copying or
  122.  
  123.                                      Page 2
  124.  
  125.  
  126.  
  127.  
  128.  
  129.             subscription, and clearly indicate that payment of such
  130.             a fee does NOT grant ownership of the programs.
  131.        
  132.           This program is part of set of utilities known as STEEN-
  133.        BURGH'S STUFF (Mildly Useful Utilities).  The full set of
  134.        utilities includes the following programs:
  135.        
  136.             BATBOX:     Simple menu creation/input system
  137.             CLK:        Displays time on screen
  138.             DOSVER:     Checks for DOS version currently running
  139.             FREEDISK:   Checks for available disk space
  140.             INPUT:      Simple prompt/input system
  141.             KLS:        Colorful screen-clearing utility
  142.             LAUNCHER:   File selection/execution system
  143.             MUSIC115:   Plays transcribed sheet music on the PC
  144.             RAND:       Random number generator
  145.             SKIP:       Prints blank lines from batch files
  146.             SOUNDER:    Wide range of noise making options
  147.             WAITFOR:    Timed pauses 
  148.             WHENISIT:   Date/time telling utility
  149.             WRITE:      Colorful output anywhere on screen
  150.             XD:         Create/switch directories at the same time
  151.        
  152.           Payment of the $10 registration fee allows automatically
  153.        registers you for the full set.
  154.        
  155.           You may evaluate these programs for up to 30 days on a free
  156.        trial basis.  After 30 days, you should register your use of
  157.        these programs.  The registration fee is $10, payable to the
  158.        author at the address given below.
  159.        
  160.           Let's be real: I don't plan to make alot of money this way.
  161.        Registration does have its advantages:
  162.        
  163.           - I am improving these programs all the time.  Registration
  164.             will get you IMMEDIATELY a disk with the latest version,
  165.             which includes a version of BATBOX with user-selected 
  166.             menu colors.  When Version 2.0 of these utilities is re-
  167.             leased, you will also receive that free of charge.
  168.        
  169.           - While I can't promise to include everyone's suggestions
  170.             in program updates, you can bet I'll listen to registered
  171.             users before any of you scrounges out there.
  172.        
  173.           - You will me feel all warm and fuzzy and appreciated, and
  174.             all that good stuff.
  175.        
  176.           - You will also get an evaluation copy of my text-file for-
  177.             matting program (used to produce the margins in this doc-
  178.             ument).
  179.        
  180.           Send comments/registrations to:
  181.        
  182.                Chuck Steenburgh
  183.  
  184.                                      Page 3
  185.  
  186.  
  187.  
  188.  
  189.  
  190.                304A North Main Street
  191.                Lexington, VA 24450
  192.                (703)464-5290
  193.        
  194.                CIS 72330,1776 (I haunt the IBMSYS and IBMPRO forums)
  195.        
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.                                      Page 4